home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / zlagtm.z / zlagtm
Text File  |  1996-03-14  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. ZZZZLLLLAAAAGGGGTTTTMMMM((((3333FFFF))))                                                          ZZZZLLLLAAAAGGGGTTTTMMMM((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ZLAGTM - perform a matrix-vector product of the form   B := alpha * A * X
  10.      + beta * B  where A is a tridiagonal matrix of order N, B and X are N by
  11.      NRHS matrices, and alpha and beta are real scalars, each of which may be
  12.      0., 1., or -1
  13.  
  14. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  15.      SUBROUTINE ZLAGTM( TRANS, N, NRHS, ALPHA, DL, D, DU, X, LDX, BETA, B, LDB
  16.                         )
  17.  
  18.          CHARACTER      TRANS
  19.  
  20.          INTEGER        LDB, LDX, N, NRHS
  21.  
  22.          DOUBLE         PRECISION ALPHA, BETA
  23.  
  24.          COMPLEX*16     B( LDB, * ), D( * ), DL( * ), DU( * ), X( LDX, * )
  25.  
  26. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  27.      ZLAGTM performs a matrix-vector product of the form
  28.  
  29.  
  30. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  31.      TRANS   (input) CHARACTER
  32.              Specifies the operation applied to A.  = 'N':  No transpose, B :=
  33.              alpha * A * X + beta * B
  34.              = 'T':  Transpose,    B := alpha * A**T * X + beta * B
  35.              = 'C':  Conjugate transpose, B := alpha * A**H * X + beta * B
  36.  
  37.      N       (input) INTEGER
  38.              The order of the matrix A.  N >= 0.
  39.  
  40.      NRHS    (input) INTEGER
  41.              The number of right hand sides, i.e., the number of columns of
  42.              the matrices X and B.
  43.  
  44.      ALPHA   (input) DOUBLE PRECISION
  45.              The scalar alpha.  ALPHA must be 0., 1., or -1.; otherwise, it is
  46.              assumed to be 0.
  47.  
  48.      DL      (input) COMPLEX*16 array, dimension (N-1)
  49.              The (n-1) sub-diagonal elements of T.
  50.  
  51.      D       (input) COMPLEX*16 array, dimension (N)
  52.              The diagonal elements of T.
  53.  
  54.      DU      (input) COMPLEX*16 array, dimension (N-1)
  55.              The (n-1) super-diagonal elements of T.
  56.  
  57.      X       (input) COMPLEX*16 array, dimension (LDX,NRHS)
  58.              The N by NRHS matrix X.  LDX     (input) INTEGER The leading
  59.              dimension of the array X.  LDX >= max(N,1).
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ZZZZLLLLAAAAGGGGTTTTMMMM((((3333FFFF))))                                                          ZZZZLLLLAAAAGGGGTTTTMMMM((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      BETA    (input) DOUBLE PRECISION
  75.              The scalar beta.  BETA must be 0., 1., or -1.; otherwise, it is
  76.              assumed to be 1.
  77.  
  78.      B       (input/output) COMPLEX*16 array, dimension (LDB,NRHS)
  79.              On entry, the N by NRHS matrix B.  On exit, B is overwritten by
  80.              the matrix expression B := alpha * A * X + beta * B.
  81.  
  82.      LDB     (input) INTEGER
  83.              The leading dimension of the array B.  LDB >= max(N,1).
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.